Obtains the attributes of a window.

OSStatus GetWindowAttributes (
    WindowRef window, 
    WindowAttributes *outAttributes
);

Parameter descriptions

window

A pointer to the window whose attributes you wish to obtain.

outAttributes

On input, a pointer to an unsigned 32-bit value of type WindowAttributes. On return, the bits are set to the attributes of the specified window. See “Window Attribute Constants” for a description of possible attributes. With Mac OS 8.5, if the window was not originally created using the function CreateNewWindow, then all attribute bits are set to 0, and GetWindowAttributes returns a paramErr (-50) result.

function result

A result code.

DISCUSSION

Window attributes specify a window’s features (such as whether the window has a close box) and logical attributes (such as whether the window receives update and activate events).

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)